[Contents]
[Index]
[Help]
[Browse <]
[Browse >]
Custom Handlers for AppIcons
--------------------------------- -- - -
Like listers with handles, AppIcons added with the addappicon command
will also cause messages to be sent. See the lister handlers section
for more details.
All AppIcon messages have the same arguments:-
Arg0 - <event> (string identifying the event)
Arg1 - <id> (ID specified in the addappicon command)
Arg2 - <data> (filenames/menu ID/other information)
Arg3 - <handle> (source lister handle - if applicable)
Arg4 - "icon" (string identifying this as an "icon" event)
These are the events that apply to AppIcons:-
doubleclick
This event indicates that an icon has been double-clicked, or has had
"Open" selected from its menu. ("Open" is replaced with "Close" if you give
the close option to dopus addappicon , and you'll get close events
instead.)
dropfrom
This is a drag'n'drop event, and indicates that one or more entries have
been dropped on this appicon from a lister or elsewhere. The names of the
entries are available in Arg2. The names will be surrounded by quotes if
you gave the quotes option to dopus addappicon .
You should not rely on the ARexx Word() function to traverse the list
of filenames because it does not support quotes and any name with a space
in it will cause your script to malfunction.
snapshot
This event occurs when the Snapshot menu item is selected. The current
position of the icon is available in Arg2 (as an x,y string). You are
responsible for storing this position. (You will only get snapshot
events if you give the snap option to dopus addappicon .)
unsnapshot
This event occurs when the Un-Snapshot menu item is selected. (You will
only get unsnapshot events if you give the snap option to
dopus addappicon .)
removed
This event warns that Opus has quit and the handler code should now clean
up and exit.
info
This event occurs when the Information menu item is selected. (You will
only get info events when you give the info option to dopus addappicon .)
close
This will occur when Close is selected from the pop-up menu. (You will only
get close events when you give the close option to dopus addappicon .)
menu
This event indicates that one of the user-supplied menu items has been
selected in the pop-up menu. The number of the menu item will be returned
in Arg2, and your base value will have been added to it if you specified
one when you called dopus addappicon .
menuhelp
This event indicates that the help key was pressed while the mouse pointer
was over one of the user-supplied menu items. The number of the menu item
will be returned in Arg2, and your base value will have been added to it if
you specified one when you called dopus addappicon .
Converted on 04 Nov 1998 with RexxDoesAmigaGuide2HTML 2.2 by Michael Ranner.